home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / SNNSV32.ZIP / SNNSv3.2 / tools / doc / analyze.doc next >
Encoding:
Text File  |  1994-04-25  |  4.7 KB  |  148 lines
  1.                  ===============================
  2.                  Description of the tool ANALYZE
  3.                  ===============================
  4.  
  5. With the program 'analyze' it is possible to analyze result files
  6. that have been created by SNNS. The result files that are to be
  7. analyzed must contain the 'teaching output' and the 'output' of the
  8. network. The 'input patterns' can also be included but have no effect.
  9.  
  10. Depending upon an 'analyzing function', ANALYZE checks whether
  11. patterns are classified correctly, incorrectly, or not at all by the
  12. neural network.  Optionally it is possible to define which patterns
  13. numbers (classified correctly, incorrectly, or unclassified) are going
  14. to be returned by ANALYZE.
  15.  
  16. Synopsis:
  17. ---------
  18.  
  19. analyze [-options]
  20.  
  21.  
  22. The following options are possible to be chosen in any order:
  23. --------------------------------------------------------------
  24.  
  25. -w        : numbers of patterns which were classified wrong are
  26.           printed (default)
  27. -r        : numbers of patterns which were classified right are
  28.           printed 
  29. -u        : numbers of patterns which were not classified are
  30.           printed
  31. -a        : same as -w -r -u
  32. -v        : verbose output. Each printed number is preceded by
  33.           one of the words 'wrong', 'right' or 'unknown'
  34.           depending on the result of the classification
  35. -s        : A statistic information containing the count of
  36.           wrong, right and not classified patterns and the
  37.           total network error is printed.
  38.           options -w -r -u -a and -v are ignored
  39. -i <file name>    : name of the 'result file' which is going to be
  40.           analyzed (default is standard input)
  41. -o <file name>    : name of the file which is to be produced by ANALYZE
  42.           (default is standard output) 
  43. -e <function>    : defines the name of the 'analyzing function'
  44.           (descriptions see below) possible names are:
  45.             402040
  46.             WTA
  47.           (default is 402040)
  48. -l <real value>    : first parameter of the analyzing function
  49.           (default values and description see below)
  50. -h <real value>    : second parameter of the analyzing function
  51.           (default values and description see below)
  52.  
  53. Starting ANALYZE without giving any options is equivalent to
  54.     analyze -w -e 402040 -l 0.4 -h 0.6
  55. while input and output files are standard input and standard output
  56.  
  57.  
  58. 'analyzing functions'
  59. ---------------------
  60.  
  61. 402040:
  62. -------
  63. A pattern is classified correctly if:
  64.     the output of exactly one output unit is >= h        AND
  65.     the 'teaching output' of this unit is the maximum
  66.     'teaching output' of the pattern            AND
  67.     the output of all other output units is <= l
  68.  
  69. A pattern is classified incorrectly if:
  70.     the output of exactly one output unit is >= h        AND
  71.     the 'teaching output' of this unit is NOT the maximum
  72.     'teaching output' of the pattern            AND
  73.     the output of all other output units is <= l
  74.  
  75. A pattern is unclassified in all other cases.
  76.  
  77. Default values used for l and h are: l=0.4  h=0.6
  78. (These default values represent the well known 40-20-40 rule if the
  79. teaching output of the network lies between 0.0 and 1.0.)
  80.  
  81. WTA:
  82. ----
  83. A pattern is classified correctly if:
  84.     there exists an output unit whose output value is 
  85.     greater than the output value of all other output units
  86.     (this output value is supposed to be o)            AND
  87.     o > h                            AND
  88.     the 'teaching output' of this unit is the maximum
  89.     'teaching output' of the pattern            AND
  90.     the output of all other output units is < a - l
  91.  
  92. A pattern is classified incorrectly if:
  93.     there exists an output unit whose output value is 
  94.     greater than the output value of all other output units
  95.     (this output value is supposed to be o)            AND
  96.     o > h                            AND
  97.     the 'teaching output' of this unit is NOT the maximum
  98.     'teaching output' of the pattern            AND
  99.     the output of all other output units is < a - l
  100.  
  101. A pattern is unclassified in all other cases.
  102.  
  103. Default values used for l and h are: l=0.0 h=0.0
  104. (These default values represent the well known winner takes all rule)
  105.  
  106.  
  107. Examples:
  108. ---------
  109.  
  110. analyze -s -i demo1.res -o demo1.no
  111.  
  112. analyzes the result file 'demo1.res' producing the output file
  113. 'demo1.no' which might look like this (or similar):
  114.  
  115. STATISTICS ( 4 patterns )
  116. wrong   :  0.00 %  ( 0 pattern(s) )
  117. right   : 75.00 %  ( 3 pattern(s) )
  118. unknown : 25.00 %  ( 1 pattern(s) )
  119. error   : 0.379660
  120.  
  121.  
  122.  
  123. analyze -w -u -v -e WTA -l 0.0 -h 0.2 < demo2.res
  124.  
  125. analyzes the result file 'demo2.res' which is redirected to standard
  126. input using the analyzing function WTA with the parameters l=0.0 and
  127. h=0.2. The output is printed to the terminal. It contains numbers of
  128. the patterns which were unclassified or classified wrong including the
  129. words 'wrong' or 'unknown'. The output might look like this:
  130.  
  131. wrong   : 7
  132. unknown : 9
  133. unknown : 10
  134.  
  135.  
  136.  
  137. analyze -r -i demo3.res -o demo3.no
  138.  
  139. analyzes the result file 'demo3.res' writing the output file
  140. 'demo3.no' which exclusively includes numbers of right classified
  141. patterns. The file might look like this:
  142.  
  143. 34
  144. 56
  145. 123
  146. 281
  147.  
  148.